home *** CD-ROM | disk | FTP | other *** search
/ Technotools / Technotools (Chestnut CD-ROM)(1993).ISO / database / proclip / proclip.doc next >
Text File  |  1987-08-23  |  30KB  |  859 lines
  1.  
  2.  
  3.  
  4.                                    PROCLIP.LIB
  5.                          - Professional Clipper Library -
  6.                                          
  7.                                    Version 1.00
  8.      ========================================================================
  9.                             Copyright Acknowledgments
  10.      
  11.                     CLIPPER is a Trademark of Nantucket, Inc.
  12.               IBM is a Trademark of International Business Machines.
  13.              Tom Rettig Library is a Trademark of Tom Rettig & Assoc.
  14.             Microsoft Overlay Linker is a Trademark of Microsoft Corp.
  15.              PLINK86plus is a Trademark of Phoenix Technologies, Ltd.
  16.      
  17.      ========================================================================
  18.      
  19.      The Professional Clipper Library (PROCLIP.LIB) is not designed to
  20.      replace the standard Nantucket Clipper Library (Winter '86), simply to
  21.      enhance its capabilities.  Some of the routines contained in PROCLIP are
  22.      undoubtedly contained in the next release from Nantucket but I needed
  23.      them now so I wrote them.  Also, as I am an avid fan (and registered
  24.      owner) of the Tom Rettig Library, I have taken precautions not to
  25.      duplicate his work.  I have coded some routines similar to his which
  26.      have enhancements, but I will not attempt to "reinvent the wheel."  The
  27.      purpose of this library is to provide the programmer with additional
  28.      tools that Nantucket and Tom haven't gotten around to releasing yet.
  29.      
  30.      I am releasing this software under the concept that most of us pay for
  31.      what we use and appreciate.  Those in the crowd who must steal from
  32.      others can have at it, but your ears will become infested with the fleas
  33.      of a thousand camels.  If these functions are useful to you and you
  34.      would like to encourage the creation of more a registration fee of
  35.      $25.00 is suggested and appreciated.  I also encourage more input into
  36.      the creation of other functions.  Every one of these functions were
  37.      created from input from other CLIPPER users such as yourself.  I'm not
  38.      too good at dreaming these things up but I can follow directions pretty
  39.      good.  Now I'm not egotistic enough to say I can write anything, but
  40.      give me an idea of what you'd like and I'll see what I can do.  I will
  41.      do my best to correct any programming problems (bugs) which are located
  42.      and brought to my attention.  I will not, however, be held responsible
  43.      for any damages either real or imagined from the use of PROCLIP.
  44.      
  45.      Also, if any of you would like to obtain the source code for this
  46.      library please send your request, along with an additional $25.00 to the
  47.      address listed below.  Currently all source code is 8088 assembler and
  48.      heavily documented.
  49.      
  50.      For registration .or. source code:
  51.      
  52.                          Genesis Development
  53.                          3504 Jasmine Lane
  54.                          Rowlett, Texas  75088
  55.                          
  56.                          Source ID: NAN779
  57.                          CompuServe: 71410,2051
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                        Page #1
  64.                                           
  65.                    Copyright (c) 1986, 1987 by Genesis Development
  66.  
  67.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  68.      ===========================================================================
  69.  
  70.      PROCLIP Usage:
  71.      
  72.      As I am particularly fond of the UDF (user defined function) command
  73.      type, most of my examples will be using them.  Only in a few cases must
  74.      we mandate the use of the procedure call format.  The UDF type simply
  75.      makes for cleaner looking code.
  76.      
  77.      In almost all cases the functions are checking the parameter count,
  78.      types and values to prevent runtime problems.  The library is using the
  79.      published CLIPPER vector names for parameter retrieval and return
  80.      (EXTENDA).  Hopefully this will prevent this library from becoming
  81.      obsolete with new versions of CLIPPER.
  82.      
  83.      Use of this library is identical to that of any other library designed
  84.      for use with CLIPPER:
  85.      
  86.      With MicroSoft Linker -
  87.      
  88.      C>LINK
  89.      Microsoft (R) Overlay Linker  Version 3.51
  90.      Copyright (C) Microsoft Corp 1983, 1984, 1985, 1986.  All rights
  91.      reserved.
  92.      
  93.      Object Modules [.OBJ]: YOURPROG
  94.      Run File [YOURPROG.EXE]:
  95.      List File [NUL.MAP]:
  96.      Libraries [.LIB]: CLIPPER + PROCLIP
  97.      
  98.      
  99.      With PLink86 -
  100.      
  101.      C>PLINK86
  102.      PLINK86plus ( Nantucket ) Version 2.21
  103.      Copyright (C) 1984, 1985, 1986 by Phoenix Technologies Ltd.,
  104.      All Rights Reserved.
  105.      
  106.      =>FI YOURPROG
  107.      =>LIB CLIPPER
  108.      =>LIB PROCLIP
  109.      
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                        Page #2
  130.                                           
  131.                    Copyright (c) 1986, 1987 by Genesis Development
  132.  
  133.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  134.      ===========================================================================
  135.  
  136.                          * * *  NOTICES & WARNINGS * * *
  137.      
  138.  
  139.      If you are using PROCLIP with any other library which contains the same
  140.  
  141.      function names (eg. SCROLL) you will see some warning errors generated
  142.  
  143.      by whichever linker you are using.  If you like the PROCLIP function
  144.  
  145.      better than the others just make certain that PROCLIP is the first
  146.  
  147.      library in the list after the CLIPPER library is specified.  Neither
  148.  
  149.      linker appreciates a bunch of functions with the same names but they
  150.  
  151.      both will use the first function of that name that they encounter.
  152.  
  153.      
  154.  
  155.      If you specify a function in CLIPPER you cannot specify it as a
  156.  
  157.      procedure in a different module of the same program and vice versa.
  158.  
  159.      What this means is...be consistent.  If you use one of the routines as a
  160.  
  161.      function (eg. newattr(10,20,12,60,'n/w') ) you cannot use it in a
  162.  
  163.      different module of the same program as a procedure (eg. call newattr
  164.  
  165.      with 10,20,12,60,'n/w').  CLIPPER will scream it's head off at you so
  166.  
  167.      you don;t have to worry about it compiling incorrectly.
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                        Page #3
  196.                                           
  197.                    Copyright (c) 1986, 1987 by Genesis Development
  198.  
  199.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  200.      ===========================================================================
  201.  
  202.      Function Name: SCROLL
  203.      
  204.           I know, I know, who doesn't already have a SCROLL routine.  The
  205.           Nantucket (DBU.LIB) and Rettig (TR86.LIB) libraries have nice
  206.           scroll routines but neither one of them let you control the
  207.           attribute of the blank line left behind.  In some of my
  208.           applications this got to be a real pain so I decided to fix it.
  209.           After studying both Nantucket and Rettig's SCROLL routines I
  210.           decided that Tom had the most sensible call format so I borrowed
  211.           it.  We won't mention the fact that I was also used to using it.
  212.      
  213.           Format:
  214.      
  215.                As a function -
  216.      
  217.                     scroll(top,left,bottom,right,lines,dir[,attr])
  218.      
  219.                As a procedure -
  220.                
  221.                     call scroll with top,left,bottom,right,lines,dir[,attr]
  222.      
  223.           Parameters:
  224.      
  225.                top.......topmost row of the area to be scrolled.  Value
  226.                          checked to be between 0 and 24 inclusive.
  227.                
  228.                left......leftmost column of the area to be scrolled.  Value
  229.                          checked to be between 0 and 79 inclusive.
  230.                
  231.                bottom....ending (bottommost?) row of the area to be scrolled.
  232.                          Value checked to be greater than TOP but less than
  233.                          or equal to 24.
  234.                
  235.                right.....rightmost column of the area to be scrolled.  Value
  236.                          checked to be greater than LEFT but less than or
  237.                          equal to 79.
  238.                
  239.                Lines.....number of lines to be scrolled, or zero (0) to
  240.                          scroll entire window (effectively erasing it).
  241.                          Value checked to be equal to or less than BOTTOM -
  242.                          TOP.
  243.                
  244.                Dir.......non case sensitive character variable or constant
  245.                          containing a flag indicating the direction of the
  246.                          scroll (u = Up & d = Down).
  247.                
  248.                Attr......non case sensitive character variable or constant
  249.                          containing a valid color command and combination for
  250.                          character and background.  Must be the alpha
  251.                          representation of the color, the numeric will be
  252.                          rejected.  This is NOT a mandatory parameter.  If
  253.                          you do not furnish it in the command line the
  254.                          function will use the attribute currently on the
  255.                          screen for the character in the TOP, LEFT position.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                        Page #4
  262.                                           
  263.                    Copyright (c) 1986, 1987 by Genesis Development
  264.  
  265.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  266.      ===========================================================================
  267.  
  268.      SCROLL (cont'd)
  269.                                   (valid colors)
  270.                          black                         N
  271.                          blue                          B
  272.                          green                         G
  273.                          cyan                          BG
  274.                          red                           R
  275.                          magenta                       RB
  276.                          brown                         GR
  277.                          white                         W
  278.                          intense                       +
  279.                          blink                         *
  280.      
  281.           Examples:
  282.      
  283.                1.   This will scroll one line down in the area from row #10,
  284.                     column #20 through row #12, column #60 using an attribute
  285.                     of black character (n) and white background (w).
  286.      
  287.                .
  288.                .
  289.                .
  290.                scroll(10,20,12,60,1,'d','n/w')
  291.                (or call scroll with 10,20,12,20,1,'d','n/w')
  292.                .
  293.                .
  294.                .
  295.      
  296.                2.   This will scroll one line down in the area from row
  297.                     #05,column #00 through row #20, column #79 using whatever
  298.                     the attribute of the character at 10,20 currently is.
  299.      
  300.                .
  301.                .
  302.                .
  303.                scroll(05,00,20,79,1,'d')
  304.                .
  305.                .
  306.                .
  307.      
  308.           Returns:
  309.      
  310.                Not a thing.  This function will either perform the function
  311.                or ignore the request because of some parameter problem.
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                        Page #5
  328.                                           
  329.                    Copyright (c) 1986, 1987 by Genesis Development
  330.  
  331.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  332.      ===========================================================================
  333.  
  334.      Function Name: NEWATTR
  335.      
  336.           This function was created for those of us who wish to highlight a
  337.           particular area of the screen without having to bother setting
  338.           colors and rewriting the text.  This is real useful if you'd like
  339.           to highlight a menu item or prompt area without having to rewrite
  340.           it.  When called with the proper parameters the function will
  341.           change the attribute of the specified area (box).
  342.      
  343.           NEWATTR in its current form uses the IBM standard BIOS interrupt
  344.           for writing to the screen.  Given this it will not "pop" onto the
  345.           screen on computers with slower clock cycles (4.77MHz - 6.0MHz).
  346.           If the need arises I will write a different version to do direct
  347.           screen writing.
  348.      
  349.           Format:
  350.      
  351.                As a function -
  352.      
  353.                     newattr(top,left,bottom,right,attr)
  354.      
  355.                As a procedure -
  356.      
  357.                     call newattr with top,left,bottom,right,attr
  358.      
  359.           Parameters:
  360.      
  361.                top.......topmost row of the area to be changed.  Value
  362.                          checked to be between 0 and 24 inclusive.
  363.                
  364.                left......leftmost column of the area to be changed.  Value
  365.                          checked to be between 0 and 79 inclusive.
  366.                
  367.                bottom....ending (bottommost?) row of the area to be changed.
  368.                          Value checked to be greater than TOP but less than
  369.                          or equal to 24.
  370.                
  371.                right.....rightmost column of the area to be changed.  Value
  372.                          checked to be greater than LEFT but less than or
  373.                          equal to 79.
  374.                
  375.                Attr......non case sensitive character variable or constant
  376.                          containing a valid color command and combination for
  377.                          character and background.  Must be the alpha
  378.                          representation of the color, the numeric will be
  379.                          rejected.
  380.      
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                        Page #6
  394.                                           
  395.                    Copyright (c) 1986, 1987 by Genesis Development
  396.  
  397.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  398.      ===========================================================================
  399.  
  400.      NEWATTR (cont'd)
  401.      
  402.                                   (valid colors)
  403.                          black                         N
  404.                          blue                          B
  405.                          green                         G
  406.                          cyan                          BG
  407.                          red                           R
  408.                          magenta                       RB
  409.                          brown                         GR
  410.                          white                         W
  411.                          intense                       +
  412.                          blink                         *
  413.      
  414.           Examples:
  415.      
  416.                1.   This will change the character attributes from row #10,
  417.                     column #20 through row #12, column #60 to intense
  418.                     blinking red on a black background (somebody must have
  419.                     hit the wrong key).
  420.      
  421.                .
  422.                .
  423.                .
  424.                newattr(10,20,12,60,'*+r/n)
  425.                .
  426.                .
  427.                .
  428.      
  429.                2.   This will change the character attributes from row #05,
  430.                     column #10 through row #05, column #15 to inverse with
  431.                     black characters.
  432.      
  433.                .
  434.                .
  435.                .
  436.                t = 05
  437.                l = 10
  438.                b = 05
  439.                r = 15
  440.                newattr(t,l,b,r,'n/w')
  441.                .
  442.                .
  443.                .
  444.      
  445.           Returns:
  446.      
  447.                Not a thing.  This function will either operate with the given
  448.                parameters of reject them due to validity checking.
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                        Page #7
  460.                                           
  461.                    Copyright (c) 1986, 1987 by Genesis Development
  462.  
  463.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  464.      ===========================================================================
  465.  
  466.      Function Name: SAVEBOX
  467.      
  468.           In Clipper if you want to use the neat BOX command to prompt for a
  469.           parameter or issue a warning and restore the screen to its original
  470.           beauty and luster, you have to save the entire screen to a memory
  471.           variable and then restore it.  This is fine but if you get too many
  472.           saved screens you'll run smack out of memory.  Each screen as saved
  473.           by CLIPPER requires a minimum of 4096 bytes.  Tom Rettig was nice
  474.           enough to allow us to slam that puppy on the disk but even this
  475.           causes more trouble than necessary.  The concept behind the SAVEBOX
  476.           function was to allow the programmer to save only a specific
  477.           section of the screen into a pre-defined memory variable.  Using
  478.           this you can save all the screen (4096 bytes) or only one character
  479.           (2 bytes) or anywhere in between.
  480.      
  481.           As this procedure requires a pre-defined character memory variable
  482.           to contain the screen data please ensure you define the variable as
  483.           this document suggests (sizewise).
  484.           
  485.           This procedure is just that, a procedure.  Do not call it as a
  486.           function because CLIPPER will not allow me to return the character
  487.           memory variable intact with all the goodies.
  488.      
  489.           Format:
  490.      
  491.                As a function -
  492.      
  493.                     none
  494.      
  495.                As a procedure -
  496.      
  497.                     call savebox with top,left,bottom,right,scrnarea
  498.      
  499.           Parameters:
  500.      
  501.                top.......topmost row of the area to be changed.  Value
  502.                          checked to be between 0 and 24 inclusive.
  503.                
  504.                left......leftmost column of the area to be changed.  Value
  505.                          checked to be between 0 and 79 inclusive.
  506.                
  507.                bottom....ending (bottommost?) row of the area to be changed.
  508.                          Value checked to be greater than TOP but less than
  509.                          or equal to 24.
  510.                
  511.                right.....rightmost column of the area to be changed.  Value
  512.                          checked to be greater than LEFT but less than or
  513.                          equal to 79.
  514.                
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                        Page #8
  526.                                           
  527.                    Copyright (c) 1986, 1987 by Genesis Development
  528.  
  529.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  530.      ===========================================================================
  531.  
  532.      SAVEBOX (cont'd)
  533.      
  534.                scrnarea..a pre-defined character memory variable which will
  535.                          contain the screen data (and some control
  536.                          information) upon return.  If the memory variable is
  537.                          not large enough to contain the total screen data
  538.                          requested it will be filled with whatever I can
  539.                          stuff into it.  Use this algorithm (Texan for
  540.                          cipher) to allocate the memory variable properly:
  541.      
  542.                          (((right - left + 1) * 2) * (bottom - top + 1)) + 6
  543.      
  544.                          The extra six (6) bytes on the end are for my
  545.                          control information.  See RESTBOX for usage of
  546.                          these.  It does not matter what the name of the
  547.                          memory variable is as long as it is a character
  548.                          type.  Use the SPACE command to allocate the
  549.                          variable.
  550.      
  551.           Examples:
  552.      
  553.                1.   To save the screen data, and current attributes, into a
  554.                     memory variable from row #10, column #20 through row #12,
  555.                     column #60.
  556.      
  557.                .
  558.                .
  559.                .
  560.                scrn1 = space((((60 - 20 + 1) * 2) * (12 - 10 + 1)) + 6)
  561.                call savebox with 10,20,12,60,scrn1
  562.                .
  563.                .
  564.                .
  565.      
  566.           Returns:
  567.      
  568.                The character memory variable will contain the data as it was
  569.                read from the screen preceded by six (6) bytes of control
  570.                information.  If this variable is released or otherwise
  571.                changed the RESTBOX function may not operate as you intended.
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                        Page #9
  592.                                           
  593.                    Copyright (c) 1986, 1987 by Genesis Development
  594.  
  595.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  596.      ===========================================================================
  597.  
  598.      Function Name: RESTBOX
  599.      
  600.           This function doesn't work too well if you don't use SAVEBOX first.
  601.           RESTBOX will restore a saved SAVEBOX memory variable to the screen
  602.           using either the original coordinates or different coordinates
  603.           provided by the programmer.  Creative use of SAVEBOX, BOX and
  604.           RESTBOX can move stuff all over the screen making the user think
  605.           you're a real wizard!
  606.           
  607.           RESTBOX in its current form uses the IBM standard BIOS interrupt
  608.           for writing to the screen.  Given this it will not "pop" onto the
  609.           screen on computers with slower clock cycles (4.77MHz - 6.0MHz).
  610.           If the need arises I will write a different version to do direct
  611.           screen writing.
  612.      
  613.           Format:
  614.      
  615.                As a function -
  616.      
  617.                     restbox([top,left,]scrnarea)
  618.      
  619.                As a procedure -
  620.      
  621.                     call restbox with [top,left,]scrnarea
  622.      
  623.           Parameters:
  624.      
  625.                top.......topmost row of the area to be changed.  Value
  626.                          checked to be between 0 and 24 inclusive.  This is
  627.                          NOT a mandatory parameter, however if TOP is
  628.                          specified then LEFT must also be specified.  If
  629.                          TOP,LEFT is not specified RESTBOX will obtain the
  630.                          original position from within the SAVEBOX'd
  631.                          variable.
  632.                
  633.                left......leftmost column of the area to be changed.  Value
  634.                          checked to be between 0 and 79 inclusive.  This is
  635.                          NOT a mandatory parameter, however if LEFT is
  636.                          specified then TOP must also be specified.
  637.                
  638.                scrnarea..a character memory variable containing a saved
  639.                          portion of the screen.  This area must have been
  640.                          saved by SAVEBOX.  No changes to this memory
  641.                          variable should have occurred between the SAVEBOX
  642.                          command and RESTBOX.
  643.      
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                                       Page #10
  658.                                           
  659.                    Copyright (c) 1986, 1987 by Genesis Development
  660.  
  661.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  662.      ===========================================================================
  663.  
  664.      RESTBOX (cont'd)
  665.      
  666.           Examples:
  667.      
  668.                1.   This will restore a previously saved screen area to the
  669.                     original location.
  670.      
  671.                .
  672.                .
  673.                .
  674.                restbox(scrn1)
  675.                .
  676.                .
  677.                .
  678.      
  679.                2.   This will restore a previously saved screen area row #10,
  680.                     column #20 even if this is a different location than it
  681.                     was originally obtained from.
  682.      
  683.                .
  684.                .
  685.                .
  686.                restbox(10,20,scrn1)
  687.                .
  688.                .
  689.                .
  690.      
  691.                3.   A typical SAVEBOX and RESTBOX combination.
  692.      
  693.                .
  694.                .
  695.                .
  696.                scrn1 = space((((60 - 20 + 1) * 2) * (12 - 10 + 1)) + 6)
  697.                call savebox with 10,20,12,60,scrn1
  698.                .
  699.                .
  700.                .
  701.                restbox(scrn1)
  702.                .
  703.                .
  704.                .
  705.      
  706.           Returns:
  707.      
  708.                Not a thing.  The screen area is restored per instructions.
  709.                If the new TOP,LEFT of the screen area forces the BOTTOM,RIGHT
  710.                of the area off the screen the program will restore what it
  711.                can to the screen stopping at the 79th column and 24th line.
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.                                       Page #11
  724.                                           
  725.                    Copyright (c) 1986, 1987 by Genesis Development
  726.  
  727.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  728.      ===========================================================================
  729.  
  730.      Function Name: CURSOR
  731.      
  732.           Rumor control has it that future versions of CLIPPER will have a
  733.           cursor handling function built in, but that it still won't give the
  734.           control this function gives.  Many is the time I wished I could set
  735.           the cursor to a different size, or make it disappear.  Well I
  736.           wished one time too many and wrote this function to solve the
  737.           problem.
  738.      
  739.           Since I do not have access to one of the new nifty keen hi
  740.           resolution monitor types recently released by Big Blue I haven't a
  741.           clue how this will function.  I am assuming two monitor types,
  742.           color (or B&W) and monochrome in this function.  If you have a
  743.           different type of monitor I would be interested in hearing how this
  744.           works.
  745.      
  746.           Format:
  747.      
  748.                As a function -
  749.      
  750.                     cursor('[std,off,half,full]')
  751.      
  752.                As a procedure -
  753.      
  754.                     call cursor with '[std,off,half,full]'
  755.      
  756.           Parameters:
  757.      
  758.                std.......sets the cursor to the default for the current
  759.                          monitor type.  Parameter may be either a literal (as
  760.                          in the examples) or a memory variable.  Case is
  761.                          insignificant as the function will perform case
  762.                          conversion prior to validation. If this is a color
  763.                          monitor then the cursor will be activated for video
  764.                          scan lines 6 thru 7.  For a monochrome monitor the
  765.                          standard activated scan lines are 12 thru 13.
  766.      
  767.                off.......sets the cursor off.  The cursor will not show on
  768.                          the current monitor.  Parameter may be either a
  769.                          literal (as in the examples) or a memory variable.
  770.                          Case is insignificant as the function will perform
  771.                          case conversion prior to validation.
  772.      
  773.                half......sets the cursor to one half of the total character
  774.                          size for the current monitor type.  Parameter may be
  775.                          either a literal (as in the examples) or a memory
  776.                          variable.  Case is insignificant as the function
  777.                          will perform case conversion prior to validation.On
  778.                          a color monitor this is scan lines 4 thru 7 and on a
  779.                          monochrome monitor is scan lines 7 thru 13.
  780.      
  781.                full......sets the cursor to cover the total character
  782.                          position for the current monitor type.  Parameter
  783.                          may be either a literal (as in the examples) or a
  784.  
  785.  
  786.  
  787.  
  788.  
  789.                                       Page #12
  790.                                           
  791.                    Copyright (c) 1986, 1987 by Genesis Development
  792.  
  793.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  794.      ===========================================================================
  795.  
  796.      CURSOR (cont'd)
  797.      
  798.                          memory variable.  Case is insignificant as the
  799.                          function will perform case conversion prior to
  800.                          validation.
  801.      
  802.           Examples:
  803.      
  804.                1.   Set the cursor to one half of the current size and then
  805.                     turn it off for some other activity.
  806.      
  807.                .
  808.                .
  809.                .
  810.                cursor('half')
  811.                .
  812.                .
  813.                .
  814.                cursor('off')
  815.                .
  816.                .
  817.                .
  818.      
  819.           Returns:
  820.      
  821.                Nothing.  Cursor is modified per the request or if the request
  822.                is invalid the command is ignored.
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.                                       Page #13
  856.                                           
  857.                    Copyright (c) 1986, 1987 by Genesis Development
  858.  
  859.